<HTML>
<BODY BGCOLOR=white>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
NAME
     Grid Engine List Library - a library providing generic  list
     functionality and database like list management

DESCRIPTION
     The Grid Engine List Library provides the functionality of a
     generic  list.  This means the list functions are applicable
     to every list based on a number of certain basic types. List
     definitions are extensible on a per program basis as long as
     the old fields remain in the list definition.

LIBRARY FUNCTIONS
     The list library provides the following functions. These are
     explained in detail in the stated man pages.

  LIST FUNCTIONS
     <B><A HREF="../htmlman3/lCreateList.html">lCreateList(3)</A></B>
          create a generic list

     <B><A HREF="../htmlman3/lCreateElemList.html">lCreateElemList(3)</A></B>
          create a generic list with a certain  number  of  empty
          elements

     <B><A HREF="../htmlman3/lFreeList.html">lFreeList(3)</A></B>
          free the memory allocated for a generic  list  and  all
          its sub-lists

     <B><A HREF="../htmlman3/lCopyList.html">lCopyList(3)</A></B>
          copy a generic list with all its sub-lists and strings

     <B><A HREF="../htmlman3/lAddList.html">lAddList(3)</A></B>
          concatenate two generic lists

     <B><A HREF="../htmlman3/lSortList.html">lSortList(3)</A></B>
          sort a generic list

     <B><A HREF="../htmlman3/lDumpList.html">lDumpList(3)</A></B>
          dump a generic list to file

     <B><A HREF="../htmlman3/lUndumpList.html">lUndumpList(3)</A></B>
          undump a generic list with all its data from file

     <B><A HREF="../htmlman3/lWriteList.html">lWriteList(3)</A></B>
          write a generic list to stdout

     <B><A HREF="../htmlman3/lGetListName.html">lGetListName(3)</A></B>
          return the name of a generic list

     <B><A HREF="../htmlman3/lGetListDescr.html">lGetListDescr(3)</A></B>
          return a pointer to the descriptor of a generic list

     <B><A HREF="../htmlman3/lGetNumberOfElem.html">lGetNumberOfElem(3)</A></B>
          return the number of list elements contained in a  gen-
          eric list

     <B><A HREF="../htmlman3/lGetNumberOfRemainingElem.html">lGetNumberOfRemainingElem(3)</A></B>
          return the number of list  elements  contained  in  the
          remainder of a generic list after a specified list ele-
          ment

  LIST ELEMENT FUNCTIONS
     <B><A HREF="../htmlman3/lCreateElem.html">lCreateElem(3)</A></B>
          create a generic list element

     <B><A HREF="../htmlman3/lFreeElem.html">lFreeElem(3)</A></B>
          frees the memory allocated for a generic list  element,
          its strings and its sub-lists

     <B><A HREF="../htmlman3/lCopyElem.html">lCopyElem(3)</A></B>
          duplicate a list element with  all  its  sub-lists  and
          strings

     <B><A HREF="../htmlman3/lAppendElem.html">lAppendElem(3)</A></B>
          append a list element to an existing list

     <B><A HREF="../htmlman3/lInsertElem.html">lInsertElem(3)</A></B>
          insert a list element into an  existing  list  after  a
          specified element

     <B><A HREF="../htmlman3/lDechainElem.html">lDechainElem(3)</A></B>
          dechain a list element from a list, the dechained  ele-
          ment is not freed

     <B><A HREF="../htmlman3/lFirst.html">lFirst(3)</A></B>
          get the first list element

     <B><A HREF="../htmlman3/lLast.html">lLast(3)</A></B>
          get the last list element

     <B><A HREF="../htmlman3/lNext.html">lNext(3)</A></B>
          get the successor of the list element

     <B><A HREF="../htmlman3/lPrev.html">lPrev(3)</A></B>
          get the predecessor of the list element

     <B><A HREF="../htmlman3/lFindFirst.html">lFindFirst(3)</A></B>
          find the first list element matching  specified  condi-
          tions

     <B><A HREF="../htmlman3/lFindLast.html">lFindLast(3)</A></B>
          find the last list element  matching  specified  condi-
          tions

     <B><A HREF="../htmlman3/lFindNext.html">lFindNext(3)</A></B>
          find the next list element starting at a  certain  list
          element matching specified conditions

     <B><A HREF="../htmlman3/lFindPrev.html">lFindPrev(3)</A></B>
          find the previous list element starting  at  a  certain
          list element matching specified conditions

     <B><A HREF="../htmlman3/lDumpElem.html">lDumpElem(3)</A></B>
          dump a list element to file

     <B><A HREF="../htmlman3/lUndumpElem.html">lUndumpElem(3)</A></B>
          undump a list element from file into memory

     <B><A HREF="../htmlman3/lWriteElem.html">lWriteElem(3)</A></B>
          write a list element to stdout

     <B><A HREF="../htmlman3/lGetPosViaElem.html">lGetPosViaElem(3)</A></B>
          get the field position of a  list  element  field  with
          name 'nm'

  FIELD ACCESS FUNCTIONS
     <B><A HREF="../htmlman3/lGetInt.html">lGetInt(3)</A></B>

     <B><A HREF="../htmlman3/lGetUlong.html">lGetUlong(3)</A></B>

     <B><A HREF="../htmlman3/lGetString.html">lGetString(3)</A></B>

     <B><A HREF="../htmlman3/lGetList.html">lGetList(3)</A></B>

     <B><A HREF="../htmlman3/lGetFloat.html">lGetFloat(3)</A></B>

     <B><A HREF="../htmlman3/lGetDouble.html">lGetDouble(3)</A></B>

     <B><A HREF="../htmlman3/lGetChar.html">lGetChar(3)</A></B>

     <B><A HREF="../htmlman3/lGetLong.html">lGetLong(3)</A></B>

          get the value of the specified type from a list element
          field;  the element and the field name are delivered as
          arguments

     <B><A HREF="../htmlman3/lSetInt.html">lSetInt(3)</A></B>

     <B><A HREF="../htmlman3/lSetUlong.html">lSetUlong(3)</A></B>

     <B><A HREF="../htmlman3/lSetString.html">lSetString(3)</A></B>

     <B><A HREF="../htmlman3/lSetList.html">lSetList(3)</A></B>

     <B><A HREF="../htmlman3/lSetFloat.html">lSetFloat(3)</A></B>

     <B><A HREF="../htmlman3/lSetDouble.html">lSetDouble(3)</A></B>
     <B><A HREF="../htmlman3/lSetChar.html">lSetChar(3)</A></B>

     <B><A HREF="../htmlman3/lSetLong.html">lSetLong(3)</A></B>

          set the value of the specified type in a  corresponding
          list  element  field; the element, the field name and a
          new value are delivered as arguments

     <B><A HREF="../htmlman3/lGetPosInt.html">lGetPosInt(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosUlong.html">lGetPosUlong(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosString.html">lGetPosString(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosList.html">lGetPosList(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosFloat.html">lGetPosFloat(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosDouble.html">lGetPosDouble(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosChar.html">lGetPosChar(3)</A></B>

     <B><A HREF="../htmlman3/lGetPosLong.html">lGetPosLong(3)</A></B>

          get the value of the specified type in a  corresponding
          list  element field; the element and the field position
          are delivered as arguments

     <B><A HREF="../htmlman3/lSetPosInt.html">lSetPosInt(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosUlong.html">lSetPosUlong(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosString.html">lSetPosString(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosList.html">lSetPosList(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosFloat.html">lSetPosFloat(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosDouble.html">lSetPosDouble(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosChar.html">lSetPosChar(3)</A></B>

     <B><A HREF="../htmlman3/lSetPosLong.html">lSetPosLong(3)</A></B>

          set the value of the specified type in a  corresponding
          list element field; the element, the field position and
          the new value are delivered as arguments

  LIST DESCRIPTOR FUNCTIONS
     <B><A HREF="../htmlman3/lInit.html">lInit(3)</A></B>
          initialize the name to string conversion

     <B><A HREF="../htmlman3/lNm2Str.html">lNm2Str(3)</A></B>
          convert an int value specifying a  field  name  to  its
          corresponding name string

     <B><A HREF="../htmlman3/_lNm2Str.html">_lNm2Str(3)</A></B>
          convert an int value specifying a  field  name  to  its
          corresponding name string using a specified name space

     <B><A HREF="../htmlman3/lStr2Nm.html">lStr2Nm(3)</A></B>
          convert a field name to its corresponding field id

     <B><A HREF="../htmlman3/_lStr2Nm.html">_lStr2Nm(3)</A></B>
          convert a field name  to  its  corresponding  field  id
          using a specified name space

     <B><A HREF="../htmlman3/lCountDescr.html">lCountDescr(3)</A></B>
          get the number of fields of a descriptor

     <B><A HREF="../htmlman3/lGetPosInDescr.html">lGetPosInDescr(3)</A></B>
          get the position of  the  field  named  'nm'  from  the
          descriptor

     <B><A HREF="../htmlman3/lDumpDescr.html">lDumpDescr(3)</A></B>
          dump a list descriptor to a file

     <B><A HREF="../htmlman3/lUndumpDescr.html">lUndumpDescr(3)</A></B>
          undump a list descriptor from a file to memory

     <B><A HREF="../htmlman3/lWriteDescr.html">lWriteDescr(3)</A></B>
          write a descriptor to stdout

  LIST DATABASE FUNCTIONS
     <B><A HREF="../htmlman3/lSelect.html">lSelect(3)</A></B>
          select returns a list of elements that match the speci-
          fied conditions.

     <B><A HREF="../htmlman3/lSelectDestroy.html">lSelectDestroy(3)</A></B>
          select reduces a list to those  elements  matching  the
          specified conditions.

     <B><A HREF="../htmlman3/lSplit.html">lSplit(3)</A></B>
          splits a list into two parts.  One  part  contains  all
          elements  fulfilling  the specified condition the other
          part contains the elements not  fulfilling  the  condi-
          tion.

     <B><A HREF="../htmlman3/lJoinSublist.html">lJoinSublist(3)</A></B>
          join a specified list with one of  its  sub-lists;  one
          can  specify  conditions for the list and the sub-list.
          The joined list is returned and the  original  list  is
          unchanged.

     <B><A HREF="../htmlman3/lJoin.html">lJoin(3)</A></B>
          join two lists which fulfill the  specified  conditions
          to a new list that contains the enumerated fields.  The
          joined list is returned  and  the  original  lists  are
          unaltered.

     <B><A HREF="../htmlman3/lWhere.html">lWhere(3)</A></B>
          build a lCondition data structure which is used as con-
          dition for various functions as lSelect or lJoin

     <B><A HREF="../htmlman3/_lWhere.html">_lWhere(3)</A></B>
          build a lCondition data structure which is used as con-
          dition for various functions as lSelect or lJoin

     <B><A HREF="../htmlman3/lOrWhere.html">lOrWhere(3)</A></B>
          build a lCondition data structure composed of two  con-
          ditions connected by logical or

     <B><A HREF="../htmlman3/lAndWhere.html">lAndWhere(3)</A></B>
          build a lCondition data structure composed of two  con-
          ditions connected by logical and

     <B><A HREF="../htmlman3/lFreeWhere.html">lFreeWhere(3)</A></B>
          free a lCondition data structure

     <B><A HREF="../htmlman3/lWriteWhere.html">lWriteWhere(3)</A></B>
          write a lCondition data structure to stdout

     <B><A HREF="../htmlman3/lWhat.html">lWhat(3)</A></B>
          build a lEnumeration data structure which  is  used  to
          specify  the  fields  that  are  contained  in  a newly
          created list element

     <B><A HREF="../htmlman3/lFreeWhat.html">lFreeWhat(3)</A></B>
          free a lEnumeration data structure

     <B><A HREF="../htmlman3/lWriteWhat.html">lWriteWhat(3)</A></B>
          write a lEnumeration data structure to stdout

     <B><A HREF="../htmlman3/lCountWhat.html">lCountWhat(3)</A></B>
          count the number  of  fields  in  a  lEnumeration  data
          structure

  DATA STRUCTURES
     The following essential data  structures  are  used  by  the
     various list library functions.

     lDescr *descriptor
          The descriptor contains the  information  which  fields
          (name, type) are contained in a list.

     lList  *list
          The lList pointer specifies a list created by lCreateL-
          ist  or  any  of the other functions generating a list.
          Here the name of the list, a reference to the  descrip-
          tor, the number of contained list elements and a refer-
          ence to the first and last list element are stored.

     lListElem *list_element
          The lListElem pointer is returned on creation of a  new
          list element and contains the actual data.

     lCondition *conditions
          The lCondition pointer is a representation of logically
          connected  compare  operations.  It  serves  to  decide
          whether it should be operated on a  special  list  ele-
          ment.

     lEnumeration *field_enumerations
          The lEnumeration pointer specifies which  fields  of  a
          given  list  element  shall  be involved in a specified
          action. It is possible under certain  circumstances  to
          specify all fields or no field at all.

     lSortOrder *sorting_order
          The lSortOrder pointer is used to specify sorting  cri-
          teria  for  a  generic  list. It is possible to declare
          combined sorting keys.

SEE ALSO
     <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B>.

COPYRIGHT
     See <B><A HREF="../htmlman1/sge_intro.html">sge_intro(1)</A></B> for a full statement of rights and  permis-
     sions.



















</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
